<html>
<head><meta charset="utf-8"><title>out of date content · t-compiler/wg-rustc-dev-guide · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/index.html">t-compiler/wg-rustc-dev-guide</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html">out of date content</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="213557639"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213557639" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213557639">(Oct 16 2020 at 13:12)</a>:</h4>
<p>I've seen in a bunch of places text like ...</p>



<a name="213557657"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213557657" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213557657">(Oct 16 2020 at 13:12)</a>:</h4>
<blockquote>
<p>The parser and lexer are currently undergoing a lot of refactoring, so parts of this chapter may be out of date.</p>
</blockquote>



<a name="213557689"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213557689" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213557689">(Oct 16 2020 at 13:12)</a>:</h4>
<p>that one in particular comes from <a href="https://rustc-dev-guide.rust-lang.org/the-parser.html">https://rustc-dev-guide.rust-lang.org/the-parser.html</a></p>



<a name="213557742"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213557742" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213557742">(Oct 16 2020 at 13:13)</a>:</h4>
<p>I'm a bit opposed to have this kind of text but wanted to also hear opinions from others</p>



<a name="213557780"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213557780" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213557780">(Oct 16 2020 at 13:13)</a>:</h4>
<p>the thing is ... everything at some point in time is under a lot of refactoring and always parts of the guide may be out of date, in particular I'm pretty sure that sections that are not up to date doesn't have a disclaimer like that</p>



<a name="213557874"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213557874" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213557874">(Oct 16 2020 at 13:14)</a>:</h4>
<p>I guess I'd rather have just a disclaimer at the beginning of the guide, saying that parts of the guide may not reflect the actual content of the guide rather than spreading a ton of notes like this through the different chapters</p>



<a name="213558921"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213558921" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213558921">(Oct 16 2020 at 13:22)</a>:</h4>
<p><span class="user-mention silent" data-user-id="116266">Santiago Pastorino</span> <a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/out.20of.20date.20content/near/213557874">said</a>:</p>
<blockquote>
<p>I guess I'd rather have just a disclaimer at the beginning of the guide, saying that parts of the guide may not reflect the actual content of the guide rather than spreading a ton of notes like this through the different chapters</p>
</blockquote>
<p>sounds good to me :)</p>



<a name="213603855"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213603855" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213603855">(Oct 16 2020 at 19:28)</a>:</h4>
<p>I guess we had added these in places where there was huge amounts of change meaning that part of the chapter may be completely outdated or in need of replacement (as opposed to normal refactoring or churn). I'm not opposed to removing them, but I'm not that bothered by them either</p>



<a name="213622836"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213622836" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jubilee <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213622836">(Oct 16 2020 at 22:56)</a>:</h4>
<p>I think for such caveats, it would be best to point to a project or wg that hopefully is documenting the change process.</p>



<a name="213669224"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213669224" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Iñaki Garay <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213669224">(Oct 17 2020 at 20:22)</a>:</h4>
<p>How about text such as "As of &lt;date or commit&gt;, ... &lt;the described situation&gt;" ?<br>
I don't think all chapters/sections should have that wording, but it might be a better alternative to "this might be out of date"</p>



<a name="213719917"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213719917" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213719917">(Oct 18 2020 at 18:57)</a>:</h4>
<p>I do like the idea of adding more specific messages, such as "as of &lt;date or commit&gt;" or a list of relevant commits/chat topics for people to refer to as mentioned above by <span class="user-mention" data-user-id="281757">@Jubilee</span></p>



<a name="213734853"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out%20of%20date%20content/near/213734853" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jubilee <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/out.20of.20date.20content.html#213734853">(Oct 19 2020 at 01:06)</a>:</h4>
<p><a href="https://github.com/rust-lang/rustc-dev-guide/issues/924">https://github.com/rust-lang/rustc-dev-guide/issues/924</a> opened an ish.</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>